home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1995 February: Tool Chest / Dev.CD Feb 95 / Dev.CD Feb 95.toast / Tool Chest / Development Tools & Languages / • Other Platforms / PCCTS / README < prev    next >
Encoding:
Text File  |  1994-09-14  |  6.9 KB  |  204 lines  |  [TEXT/MPS ]
  1.  
  2.                             Welcome to PCCTS 1.23
  3.  
  4.                               September 13, 1994
  5.  
  6.  
  7.                           Parr Research Corporation
  8.                                     with
  9.                   Purdue University Electrical Engineering
  10.                                     and
  11.                        University of Minnesota, AHPCRC
  12.  
  13.                                 Terence Parr
  14.                                 Russell Quong
  15.                                  Will Cohen
  16.                                  Hank Dietz
  17.  
  18.  
  19.                                 INSTALLATION
  20.  
  21.      This document describes the installation of PCCTS 1.23 on UNIX
  22. and non-UNIX machines.  The UNIX installation is trivial while the
  23. non-UNIX folks have a bit more work to do as an install script
  24. explicitly for there machine will not exist--they will have to
  25. interpret the install script.
  26.  
  27.      PCCTS 1.23 includes a number of different programs and examples
  28. in the software release package -- most of which like to live in their
  29. own directories.  The install script will build a standard hierarchy.
  30. Or, if you get the tar file off the ftp site, the hierarchy will be
  31. constructed automatically by tar.
  32.  
  33.      The PCCTS executables (antlr, dlg) may be placed anywhere the user
  34. wishes but the install script places them in the bin directory created
  35. during installation.
  36.  
  37. 1.0.  UNIX USERS
  38.  
  39. This section is for UNIX users and describes the most convenient
  40. installation procedure.
  41.  
  42. 1.1.  FORMAT: pccts.tar
  43.  
  44. To begin installation, place the pccts.tar file into the directory
  45. where you want to place a pccts subdirectory.  Untar the file with
  46.  
  47.      tar xvf pccts.tar
  48.  
  49. and cd into it.  To install PCCTS, simply type
  50.  
  51.      make
  52.  
  53. which will build the standard PCCTS directory hierarchy (under the
  54. directory where you ran the install script) and build executable
  55. versions of antlr and dlg.
  56.  
  57. 1.2.  FORMAT: pccts.bag
  58.  
  59.      To begin installation, the user should create a directory (usually
  60. called pccts) where the PCCTS source subtree is to be created.  Place
  61. the pccts.bag file and the install script into this directory and cd
  62. into it.  To install PCCTS, simply type
  63.  
  64.      sh install
  65.  
  66. which will build the standard PCCTS directory hierarchy (under the
  67. directory where you ran the install script), "unbag" all of the files
  68. and build executable versions of antlr and dlg.
  69.  
  70. If you do not have the 'sh' shell, you'll need the install.unbag.reqd
  71. file.
  72.  
  73. 2.0.  NON-UNIX USERS
  74.  
  75.      ANTLR was written using portable (we hope), vanilla K&R-style C,
  76. ANSI C, and C++.  It has been successfully ported to a variety of
  77. environments.  We do not provide an installation script explicitly for
  78. non-Unix users.  You must interpret the install script and perform the
  79. analogous operations on your machine.  There is an install script,
  80. install.mpw, for Macintosh programmers.
  81.  
  82. IMPORTANT NOTE:  For PC users:  You must create the parser.dlg and
  83.                  "touch" scan.c in antlr and dlg directories or the
  84.                  makefiles will try to execute antlr and dlg, which
  85.                  don't exist yet.  The first time, you want only to
  86.                  compile the C files in order to obtain an executable
  87.                  for antlr and dlg.  From this point, a change in
  88.                  antlr.g or dlg_p.g will force antlr/dlg to regenerate
  89.                  themselves.
  90.  
  91.                  You must define symbol PC if you want things to work
  92.                  out right for use on a DOS, OS/2, Windows machine.
  93.                  This affects the config.h file, which you can change
  94.                  as you wish.
  95.  
  96.      For Mac programmers using MPW (Macintosh Programmer's Workshop),
  97. define symbol MPW to get the correct config.h stuff included.
  98.  
  99. 3.0.  EMAIL VERSION RECIPIENTS
  100.  
  101.      If you received PCCTS via email response from
  102. pccts@ecn.purdue.edu you have one additional installation step to
  103. perform over the ftp folks (and pccts.tar is unavailable).  You will
  104. have received a number of bite-size chunks of pccts which are small
  105. enough to be emailed (~1500 lines each).  You must reconstruct the
  106. PCCTS files before you can begin installation.  In order to rebuild an
  107. original file, you must have "one.c" which will take the chunks and
  108. pack them together.  If you are a non-UNIX type, you must have the
  109. "unbag.c" file which unbags the bags created by our mail archiver.
  110. UNIX folks use the shell to unbag as they would for shar files (this
  111. will be done automatically by the install script).
  112.  
  113.      To install PCCTS, place all PCCTS mail messages into a pccts
  114. directory, remove the mail headers from one.c.  Then compile one.c
  115. with:
  116.  
  117.      cc -o one one.c
  118.  
  119. and then type:
  120.  
  121.      ./one f1 f2 ... fn
  122.  
  123. where f1..fn are the parts of PCCTS source sent as chunks (i.e. these
  124. files will be all the files you received NOT including one.c, unbag.c,
  125. README, install and the request acknowledge banner).  There is no need
  126. to remove mail headers from the chunk files and they may appear in any
  127. order.  The subject line of the mail will identify it as a chunk and a
  128. chunk of what file.  The "one" program should be used to put pccts.bag
  129. back together.  You are now in a position to begin normal PCCTS
  130. installation.  All files you receive should go into a pccts directory.
  131.  
  132.      Note that all files which arrive in "chunks" must be put back
  133. together using "one".  Beware that you do not mix chunks from more
  134. than one original file.  For instance, do not specify all chunks that
  135. you collect from the PCCTS mailbot on the "one" command line unless
  136. you have requested only one original file that was split into multiple
  137. files.  Each chunk knows which original file it is a part of, where it
  138. goes in that file and how many total chunks are required to rebuild
  139. that original.
  140.  
  141. 4.0.  WORD SIZE AND PC USERS
  142.  
  143.      The config.h file now sets up the word size for your compiler
  144. automatically.
  145.  
  146.  
  147.                                 TUTORIAL
  148.  
  149.      The advanced tutorial should be placed in a directory at the
  150. same level as antlr, dlg, support etc...  Do a
  151.  
  152.      sh advtut.bag
  153.  
  154. to unbag (or use the unbag program) and then type
  155.  
  156.      make -s all
  157.  
  158. which will create executables called tut1-tut4.  Naturally, if you got
  159. the tutorials from the ftp site, the tar format of the tutorials can
  160. be obtained for easier installation.
  161.  
  162. Unfortunately, the tutorials have changed little since the 1.06
  163. release.  With luck, these will be enhanced and an AST tutorial will
  164. appear.
  165.  
  166.                               NEW FEATURES
  167.  
  168. o  Parser Black Box class
  169.  
  170. o  Bug fixes / C++ cleanup work
  171.  
  172.  
  173.                          MACHINE COMPATIBILITY
  174.  
  175. PCCTS 1.2x is known to compile "out of the box" on the following
  176. machines and/or operating systems:  [didn't have time to retest on all
  177. these machines, but seems to be highly portable still].
  178.  
  179. o  DECSTATION 5000
  180.  
  181. o  SGI, Running IRIX 4.0.5
  182.  
  183. o  Sun SparcStation (cc, gcc, g++, Cfront, acc)
  184.  
  185. o  VAX C under VMS
  186.  
  187. o  Linux SLS 0.99, gcc/g++
  188.  
  189. o  386 PC, NetBSD 0.9, gcc 2.4.5
  190.  
  191. o  HP 9000/755, HP-UX 9.01, HP cc
  192.  
  193. o  486 PC, OS/2 2.1 (w/long filenames), IBM C Set++ 2.1
  194.  
  195.  
  196.                            INCOMPATIBILITIES
  197.  
  198. Please see the release notes.
  199.  
  200.  
  201.                                 CREDITS
  202.  
  203. Please see the history.ps or history.txt.
  204.